home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / relnotes / impactvideo / ch4.z / ch4
Encoding:
Text File  |  2001-04-17  |  6.9 KB  |  265 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        4.  _D_o_c_u_m_e_n_t_a_t_i_o_n__A_d_d_i_t_i_o_n_s__a_n_d__E_r_r_o_r_s
  9.  
  10.        4.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s__t_o__C_o_n_t_r_o_l_s
  11.  
  12.        The following sections list, by node, the changes or
  13.        additions made to the control set.
  14.  
  15.        _D_e_v_i_c_e _N_o_d_e
  16.  
  17.           +o VL_MGV_INPUT_ALPHA_LUT_SELECT,
  18.             VL_MGV_OUTPUT_ALPHA_LUT_SELECT. These controls have
  19.             been moved to the Blender node.
  20.  
  21.        _S_c_r_e_e_n _S_o_u_r_c_e _N_o_d_e
  22.  
  23.           +o The valid ports for the screen source nodes are:
  24.  
  25.              VL_IMPACT_PORT_PIXEL_SRC_A - Single-link 8-bit pixel
  26.             source from graphics
  27.              VL_IMPACT_PORT_ALPHA_SRC_A - Single-link 8-bit alpha
  28.             source from graphics
  29.  
  30.             The screen source nodes do not have
  31.             VL_IMPACT_PORT_PIXEL_SRC_B or
  32.             VL_IMPACT_PORT_ALPHA_SRC_B ports.
  33.  
  34.        _V_i_d_e_o _D_r_a_i_n _N_o_d_e
  35.  
  36.           +o VL_MGV_OUTPUT_HPHASE, VL_MGV_OUTPUT_ALPHA_HPHASE. These
  37.             controls have range -3071 to 1023 pixels. A value of 0,
  38.             the default, indicates that the output is aligned to
  39.             reference.
  40.  
  41.           +o VL_MGV_INPUT_ALPHA_LUT_SELECT,
  42.             VL_MGV_OUTPUT_ALPHA_LUT_SELECT. These controls reside
  43.             on the blender node. The input lut is enabled only when
  44.             a source from outside the CC1 is routed to a blender
  45.             alpha input. Likewise, the output lut is enabled only
  46.             when the blender alpha output is sent outside the CC1.
  47.  
  48.        _B_l_e_n_d_e_r _N_o_d_e
  49.  
  50.           +o VL_MGV_BLANK_ALPHA_CHROMA. This control resides on the
  51.             blender node and allows the chromanince components to
  52.             be blanked on the alpha output. Valid values for this
  53.             control are:
  54.  
  55.              TRUE   Blank chroma
  56.              FALSE  Pass chroma
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.             Default: FALSE (pass chroma)
  75.  
  76.             Type: boolVal
  77.  
  78.           +o VL_MGV_BLEND_A_ALPHA_SELECT. This control allows the
  79.             blender foreground alpha input to be selected from the
  80.             external source (VL_BLEND_A_ALPHA), or one of the
  81.             internal sources (key generator or 0.0). Valid values
  82.             for this control are:
  83.  
  84.              0      External Blender Input
  85.              1      Key Generator
  86.              2      0.0
  87.  
  88.             Default:  0 (External Blender Input)
  89.  
  90.             Type: intVal
  91.  
  92.           +o VL_MGV_BLEND_B_SELECT. This control allows the blender
  93.             background pixel to be selected from the external
  94.             source (VL_BLEND_B), or one of the internal sources
  95.             (flat background generator). Valid values for this
  96.             control are:
  97.  
  98.              0      External Blender Input
  99.              1      Flat Background (Constant YUV) Generator
  100.  
  101.             Default:  0 (External Blender Input)
  102.  
  103.             Type: intVal
  104.  
  105.           +o VL_MGV_BLEND_B_ALPHA_SELECT. This control allows the
  106.             blender background alpha to be selected from the
  107.             external source (VL_BLEND_B), or one of the internal
  108.             sources (0.0, 1.0). Valid values for this control are:
  109.  
  110.              0      External Blender Input
  111.              1      0.0
  112.              2      1.0
  113.  
  114.             Default:  0 (External Blender Input)
  115.  
  116.             Type: intVal
  117.  
  118.        4.2  _F_r_a_m_e_-_A_c_c_u_r_a_t_e__C_o_n_t_r_o_l__S_e_t_t_i_n_g
  119.  
  120.        Prior to Release 6.5, an application setting a control on a
  121.        video stream had no guarantees about which frame/field of
  122.        video the control would first take effect on.  Starting in
  123.        Release 6.5, OCTANE Digital Video and IMPACT Video provide
  124.        the ability to specify the frame/field of video at which
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        some controls take effect.  _v_l_S_e_t_C_o_n_t_r_o_l_I_n_L_i_n_e(_3_d_m) and
  141.        _v_l_S_e_t_C_o_n_t_r_o_l_T_r_i_g_g_e_r(_3_d_m) provide interfaces to exercise this
  142.        capability.  Refer to the man pages for further information
  143.        on the use of these interfaces.
  144.  
  145.        The following limitations apply to frame-accurate control
  146.        changes on OCTANE Digital Video and IMPACT Video.
  147.  
  148.           +o Triggered controls are supported using MSC and GPI
  149.             only.
  150.  
  151.           +o To set a control at a designated time, IRIX realtime
  152.             performance guarantees are relied upon.  To maintain
  153.             these guarantees, applications should not be run at
  154.             realtime priorities higher than priority 155. In
  155.             addition, adequate memory must be present on the system
  156.             to prevent significant levels of paging, as this can
  157.             also interfere with realtime response. (If a control is
  158.             executed later than the designated time due to the
  159.             above-mentioned causes, or because it was submitted
  160.             late, a VLAdvanceMissed event is sent to the
  161.             application).
  162.  
  163.           +o Only the following controls can be set with frame-
  164.             accuracy:
  165.  
  166.             VL_MGV_WIPE_TYPE
  167.             VL_MGV_WIPE_DIRECTION
  168.             VL_MGV_WIPE_SHARPNESS
  169.             VL_MGV_WIPE_ANGLE
  170.             VL_MGV_WIPE_POSN
  171.             VL_MGV_WIPE_POSN_PERP
  172.             VL_MGV_WIPE_CENT
  173.             VL_MGV_WIPE_CENT_PERP
  174.             VL_MGV_WIPE_REPT
  175.             VL_MGV_WIPE_REPT_PERP
  176.             VL_MGV_WIPE_FUZZ
  177.             VL_MGV_CC1_BLANK_WIDTH_CH1
  178.             VL_MGV_CC1_BLANK_WIDTH_CH2
  179.             VL_MGV_CC1_INPUT_ROUNDING_CH1
  180.             VL_MGV_CC1_INPUT_ROUNDING_CH2
  181.             VL_MGV_OUTPUT_FSYNC
  182.             VL_MGV_OUTPUT_DL_SELECT_FREEZE
  183.             VL_MGV_OUTPUT_DL_SELECT_FSYNC
  184.             VL_MGV_KEYER_SOURCE
  185.             VL_MGV_KEYER_MODE
  186.             VL_MGV_KEYER_VALUE_LUMA
  187.             VL_MGV_KEYER_RANGE_LUMA
  188.             VL_MGV_KEYER_FG_OPACITY
  189.             VL_MGV_KEYER_VALUE_CHROMA_U
  190.             VL_MGV_KEYER_RANGE_CHROMA_U
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.             VL_MGV_KEYER_VALUE_CHROMA_V
  207.             VL_MGV_KEYER_RANGE_CHROMA_V
  208.             VL_MGV_KEYER_DETAIL
  209.             VL_MGV_BLEND_B_Y
  210.             VL_MGV_BLEND_B_U
  211.             VL_MGV_BLEND_B_V
  212.             VL_MGV_BLEND_H_FILT
  213.             VL_MGV_BLEND_SHADOW_ON
  214.             VL_MGV_BLEND_SHADOW_GAIN
  215.             VL_MGV_BLEND_SHADOW_OFFSET
  216.             VL_MGV_OUTPUT_ALPHA_CHROMA
  217.             VL_MGV_BLENDER_XYMIX
  218.             VL_MGV_BLENDER_THRESH
  219.             VL_MGV_BLENDER_VRAND
  220.             VL_MGV_BLENDER_HRAND
  221.             VL_MGV_BLENDER_SLICE_SEL
  222.             VL_MGV_BLENDER_SEL_MODE
  223.             VL_MGV_CSC_COEF
  224.             VL_MGV_CSC_LUT_IN_PAGE
  225.             VL_MGV_CSC_LUT_ALPHA_PAGE
  226.             VL_FREEZE
  227.             VL_BLEND_A_FCN
  228.             VL_BLEND_B_FCN
  229.             VL_BLEND_A_NORMALIZE
  230.             VL_BLEND_B_NORMALIZE
  231.             VL_BLEND_OUT_NORMALIZE
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.